Aviation API
1 Terminal Aerodrome Forecasts (TAF)
A terminal aerodrome forecast (TAF) is a concise statement of the expected meteorological conditions at an airport during a specified period (typically 24 hours, but increasing to 30 hours from 31 August 2022).
1.1 Latest for a Location
Request the latest forecast of expected meteorological conditions for a specific airport location.
Any supported 4-letter airport ICAO code is accepted.
1.1.1 API Call:
GET /aviation/taf/{location}/latest1.1.2 Parameters:
1.1.2.1 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| Location | NZWN | A supported 4-letter airport ICAO code. The ICAO code must be uppercase. This parameter is Mandatory. |
1.1.2.2 Query Parameters:
| Query Parameter | Example | Description |
|---|---|---|
| format | geojson | Specifying this parameter will result in the forecast information contained in the TAF being returned in a GeoJSON format. Valid values: json (default) geojson This parameter is Optional. |
1.1.3 Examples:
This example would return a forecast of expected meteorological conditions at Wellington airport in GeoJSON format.
GET /aviation/taf/NZWN/latest?format=geojson1.1.4 API Response:
{
"version": "1.0",
"issue-time": "2022-07-05T02:35:43Z",
"path": "/aviation/api/aviation/taf/NZWN/latest?format=geojson",
"response": [
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
174.7999,
-41.3333,
4
]
},
"properties": {
"reportStatus": "NORMAL",
"location": "NZWN",
"issueTime": "2022-07-04T23:40:00Z",
"validFrom": "2022-07-05T00:00:00Z",
"validTo": "2022-07-06T00:00:00Z",
"baseForecast": [
{
"validFrom": "2022-07-05T00:00:00Z",
"validTo": "2022-07-06T00:00:00Z",
"cloudAndVisibilityOK": false,
"weather": [
"Light precipitation of rain"
],
"surfaceWind": {
"variableWindDirection": false,
"meanWindDirection": {
"value": 340,
"unit": "deg"
},
"meanWindSpeed": {
"value": 20.0,
"unit": "Kn"
},
"windGustSpeed": {
"value": 35.0,
"unit": "Kn"
}
},
"horizontalVisibility": {
"value": 9999,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Few",
"base": {
"value": 1500,
"unit": "Ft"
}
},
{
"amount": "Broken",
"base": {
"value": 3000,
"unit": "Ft"
}
}
]
}
}
],
"changeForecast": [
{
"changeIndicator": "TEMPORARY_FLUCTUATIONS",
"validFrom": "2022-07-05T04:00:00Z",
"validTo": "2022-07-05T10:00:00Z",
"cloudAndVisibilityOK": false,
"weather": [
"Precipitation of rain"
],
"horizontalVisibility": {
"value": 5000,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Broken",
"base": {
"value": 1400,
"unit": "Ft"
}
}
]
}
},
{
"changeIndicator": "BECOMING",
"validFrom": "2022-07-05T06:00:00Z",
"validTo": "2022-07-05T08:00:00Z",
"cloudAndVisibilityOK": false,
"surfaceWind": {
"variableWindDirection": false,
"meanWindDirection": {
"value": 340,
"unit": "deg"
},
"meanWindSpeed": {
"value": 12.0,
"unit": "Kn"
}
}
},
{
"changeIndicator": "FROM",
"validFrom": "2022-07-05T13:00:00Z",
"validTo": "2022-07-06T00:00:00Z",
"cloudAndVisibilityOK": false,
"surfaceWind": {
"variableWindDirection": false,
"meanWindDirection": {
"value": 180,
"unit": "deg"
},
"meanWindSpeed": {
"value": 15.0,
"unit": "Kn"
}
},
"horizontalVisibility": {
"value": 9999,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Few",
"base": {
"value": 2000,
"unit": "Ft"
}
}
]
}
}
]
}
}
]
}
]
}1.2 Last n days for a Location
Request up to 7 days of historical TAF’s for a specific airport location. Any supported 4-letter airport ICAO code is accepted.
1.2.1 API Call:
GET /aviation/taf/{location}/last/{n}/days1.2.2 Parameters:
1.2.2.1 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| Location | NZWN | A supported 4-letter airport ICAO code. The ICAO code must be uppercase. This parameter is Mandatory. |
| n | 3 | This is between 1 and 7 days of data. This parameter is Mandatory. |
1.2.2.2 Query Parameters:
| Query Parameter | Example | Description |
|---|---|---|
| format | geojson | Specifying this parameter will result in the forecast information contained in the TAF being returned in a GeoJSON format. Valid values: json (default) geojson This parameter is Optional. |
1.2.3 Example:
This example would return all TAF’s issued in the last 3 days for Wellington airport.
GET /aviation/taf/NZWN/last/3/days1.2.4 API Response:
{
"version":"1.0",
"issue-time":"2018-01-15T21:58:28Z",
"path":"/aviation/api/aviation/taf/NZWN/last/3/days",
"response":[
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-13T05:03:00Z",
"met:valid-from":"2018-01-13T06:00:00Z",
"met:valid-to":"2018-01-14T06:00:00Z",
"met:data":"TAF NZWN 130503Z 1306/1406 36012KT 9999 FEW030="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-13T11:01:00Z",
"met:valid-from":"2018-01-13T12:00:00Z",
"met:valid-to":"2018-01-14T12:00:00Z",
"met:data":"TAF NZWN 131101Z 1312/1412 36010KT 9999 SCT015\n FM140100 20010KT 9999 FEW030\n BECMG 1407/1409 03005KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-14T05:07:00Z",
"met:valid-from":"2018-01-14T06:00:00Z",
"met:valid-to":"2018-01-15T06:00:00Z",
"met:data":"TAF NZWN 140507Z 1406/1506 36010KT 9999 SCT020\n BECMG 1502/1504 20005KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-14T23:07:00Z",
"met:valid-from":"2018-01-15T00:00:00Z",
"met:valid-to":"2018-01-16T00:00:00Z",
"met:data":"TAF NZWN 142307Z 1500/1600 36010KT 9999 SCT030\nBECMG 1500/1502
18010KT\nBECMG 1507/1509 36012KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-15T05:10:00Z",
"met:valid-from":"2018-01-15T06:00:00Z",
"met:valid-to":"2018-01-16T06:00:00Z",
"met:data":"TAF NZWN 150510Z 1506/1606 18008KT 9999 FEW030\nBECMG 1506/1509 36012KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-15T17:20:00Z",
"met:valid-from":"2018-01-15T18:00:00Z",
"met:valid-to":"2018-01-16T18:00:00Z",
"met:data":"TAF NZWN 151720Z 1518/1618 01010KT 9999 -SHRA SCT030 BKN040\n FM160100 18008KT 9999 SCT040\n BECMG 1606/1609 01012KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-13T05:03:00Z",
"met:valid-from":"2018-01-13T06:00:00Z",
"met:valid-to":"2018-01-14T06:00:00Z",
"met:data":"TAF NZWN 130503Z 1306/1406 36012KT 9999 FEW030="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-13T17:05:00Z",
"met:valid-from":"2018-01-13T18:00:00Z",
"met:valid-to":"2018-01-14T18:00:00Z",
"met:data":"TAF NZWN 131705Z 1318/1418 36010KT 9999 SCT015\nFM140100 20010KT 9999 FEW030\nBECMG 1407/1409 03005KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-14T03:05:00Z",
"met:valid-from":"2018-01-14T03:00:00Z",
"met:valid-to":"2018-01-15T00:00:00Z",
"met:data":"TAF AMD NZWN 140305Z 1403/1500 36012KT 9999 SCT020\n BECMG 1403/1405 20010KT\n BECMG 1407/1409 03012KT="
},
{
"met:domain":"aviation",
"met:product-name":"taf",
"av:taf-location":"NZWN",
"met:issue-time":"2018-01-14T17:10:00Z",
"met:valid-from":"2018-01-14T18:00:00Z",
"met:valid-to":"2018-01-15T18:00:00Z",
"met:data":"TAF NZWN 141710Z 1418/1518 36008KT 9999 SCT040="
}
]
}